Script Author: Lisztdreams
Contact: 5Mods ID - Lisztdreams
QQ Email - 757946163@qq.com
Bilibili UID - 452301387
Script Update Date: 2026.04.25
(Do not modify, repackage, or redistribute without the author's permission)

------------------Script Introduction---------------------

GTA V Persistent Fuel System Script - Immersive Driving Experience

Introduction:

Want your driving experience in Los Santos to be more realistic? This fuel system script gives every vehicle you drive a soul – fuel is no longer an infinite number, but a resource that needs careful management. From high‑RPM fuel guzzling to economical gentle driving, from fluctuating gas station prices to manual engine start/stop, every detail whispers to you: this is not just a racing game, it's a living world.

Requirements

Before enjoying the fuel simulation, make sure you have installed the following necessary components:

ScriptHookV: The base Rockstar game script hook, required

ScriptHookVDotNet: The .NET script loader, required

DashHook: Optional plugin (https://www.gta5-mods.com/tools/dashhook) – passes fuel data to third‑party dashboard mods (e.g., realistic vehicle gauges). When fuel drops below 3 liters, this script will automatically light up the fuel warning light on the dashboard to remind you to refuel soon. Highly recommended.

Visual C++ Redistributable: Runtime environment, usually already installed.

Installation: Place the compiled FuelSystem.dll into your GTAV/scripts folder. On first run, it will automatically generate the FuelSystem.ini configuration file.

Core Mechanics: Every Throttle Press Burns Real Fuel

Fuel Consumption Model – More Detailed than Reality

Fuel consumption is not a fixed number; it is dynamically determined by speed, engine RPM, throttle input, and vehicle class:

Speed curve: Low speed (0‑60 km/h) is relatively economical. The most fuel‑efficient speed is around 70‑80 km/h. After that, aerodynamic drag increases sharply and fuel consumption rises steeply – above 300 km/h, fuel pours out like a flood.

RPM factor: At low RPM, fuel efficiency is high; when the tachometer needle approaches the redline, the engine roars and devours fuel, increasing consumption by more than 30%.

Throttle response: Light throttle (10%) gives a moderate increase; full throttle (100%) can consume up to 1.6 times as much as idle – gentle driving is the way to save fuel.

Vehicle class multiplier: Motorcycles are economical, supercars drink fuel like water, and large trucks are real gas guzzlers. Each class has its own unique consumption multiplier.

You can monitor instant fuel consumption (L/100km) in real time and feel the difference in driving styles.

Fuel Status & HUD

The script offers two display modes, toggle with the K key:

Compact fuel bar mode (default): A refined colored bar at the bottom of the screen, changing from bright orange (full) to dark red (almost empty), with 5‑liter tick marks – easy to read at a glance.

Full text mode (press K to switch to this mode): Displays current fuel / tank capacity, instant fuel consumption, average fuel consumption, estimated range, and real‑time throttle percentage.

Gas Stations & Fuel Price System

More than 30 real gas stations are pre‑placed across the map. The detection range is enlarged to 12 meters – you don't need to drive directly onto the pump to trigger the refueling zone.

Daily fluctuating fuel price: The price refreshes every in‑game day and randomly varies between $3 and $8 per liter, simulating a real market.

Refueling process: Drive into a gas station area → turn off the engine and come to a complete stop → press T to start refueling → automatically adds 0.8 liters of fuel every second while deducting the appropriate cost → press T again or start the engine to stop.

Helpful hints: When you approach a station, the game shows today's fuel price and operation instructions on screen.

Note: You cannot refuel while the engine is running or the vehicle is moving – safety first!

Manual Engine Start/Stop

By default, press Space + Enter together to manually turn the engine on or off:

When turned off, the vehicle becomes undrivable and fuel consumption stops.

Restarting requires a short cooldown (to avoid accidental toggles) and there must be fuel in the tank.

This feature is useful for refueling at stations, saving fuel while parked, or pure role‑playing.

Persistent Fuel Data

Every vehicle's remaining fuel is permanently stored in the [Fuel] section of FuelSystem.ini. Even if you completely quit the game and restart, each vehicle's fuel level is restored exactly as it was – no automatic refill on restart.

The script distinguishes different license plates on the same model: each license plate is treated as an independent vehicle record with its own fuel level. For example, two identical "Infernus" cars with different plates will each have their own fuel value stored separately.

Tank capacity is the same for all vehicles of the same model (you can override capacity per model using the [Models] section). So every copy of the same model shares the same tank size, but each individual car can have a different current fuel amount.

Supports matching existing save data using license plate, model name, or hash value – no matter which car you drive, the system will correctly restore its previous fuel level.

Fuel records for every vehicle you have ever driven are kept – none are lost.

DashHook Integration

If you have installed the DashHook plugin (a vehicle dashboard data interface), this script will automatically push the current fuel percentage to the third‑party dashboard mod, so you can see the fuel gauge needle move accurately from inside the car. Most notably, when the fuel level drops below 3 liters, the script actively lights up the fuel warning light on the dashboard, giving you the most direct visual warning while driving – a reminder to find a gas station soon.

Custom Configuration

All parameters can be adjusted via scripts/FuelSystem.ini.

Final Words

This fuel system is not meant to annoy players, but to add a touch of realism to every road trip in Los Santos. When you see your estimated range plummeting after aggressive driving, when you carefully choose the right moment to refuel, when you feel the engine's "thirst" at high RPM – you'll realise that every journey from A to B becomes a little game of balancing fuel consumption.

Now, fasten your seatbelt, keep an eye on your fuel gauge, and may every drop of fuel be meaningful.

------------------Script Configuration File Notes---------------------

Below are explanations of the main options in FuelSystem.ini. You can find this file in the scripts folder under your GTA V root directory.

[General]
DebugMode = 0 # Debug mode, 0=off, 1=on (shows vehicle matching info when you enter a car)
ReloadHotkey = 116 # Hotkey to reload the config file, 116 = F5
GlobalFuelGaugeOffset = 0.0 # Global fuel gauge needle offset (only affects DashHook)

[HUD]
FuelBarMode = 1 # HUD mode, 1 = compact fuel bar, 0 = full text mode
FuelBar = 0.0755/0.808/0.139/0.006 # Fuel bar position & size (X/Y/Width/Height)
FuelBarShowTicks = 1 # Show 5‑liter tick marks on the fuel bar
ShowThrottleHUD = 1 # Show throttle percentage in full text mode

The following are position & scale of each text item in full text mode (X/Y/Z/Scale)
Fuel = 0.02/0.02/0/0.4
Inst = 0.02/0.06/0/0.35
Avg = 0.02/0.10/0/0.35
Range = 0.02/0.14/0/0.35
Price = 0.85/0.02/0/0.35
Throttle = 0.02/0.18/0/0.35
HUDColorA = 255 # Text alpha (0‑255)

[Keys]
EngineToggleKey1 = 32 # First key for engine start/stop (Space)
EngineToggleKey2 = 13 # Second key for engine start/stop (Enter)
RefuelKey = 84 # Refuel key (T)
FuelBarToggleKey = 75 # HUD mode toggle key (K)

[Stations]
Gas station coordinates, one per line, format: X,Y,Z. You can add or remove entries as you wish.

[Models]
Set tank capacity (liters) for specific models. Format: ModelName = Capacity
Example: INFERNUS = 75

[FuelGaugeOffset]
Calibrate DashHook fuel gauge needle offset for specific models. Format: ModelName = Offset (range roughly -0.1 to 0.1)
Example: ADDER = 0.05

[Fuel]
Persistent fuel data area, automatically maintained by the script. Do not edit manually.